7.1 /init - 初始化命令

概述#

/init 命令是 Claude Code 的核心命令，用于初始化项目知识图谱。它会扫描当前文件夹下的所有文件，将解析结果保存到 CLAUDE.md 文件中，为后续对话提供完整的项目上下文。

基本语法#

bash
复制
/init

功能说明#

执行 /init 命令后，Claude Code 会：

1. 扫描当前目录下的所有文件
2. 解析文件内容并生成项目知识图谱
3. 将解析结果保存到 CLAUDE.md 文件中
4. 后续对话会自动引用该文件作为上下文

使用场景#

1. 新项目初始化#

当你首次在项目中使用 Claude Code 时，建议先运行 /init 命令，让 AI 全面了解项目结构和代码。

bash
复制
# 在项目根目录执行初始化
/init

2. 项目文件更新后重新初始化#

当项目文件结构或关键代码发生较大变化时，可以再次运行 /init 命令，更新 CLAUDE.md 文件，确保 AI 拥有最新的项目上下文。

bash
复制
# 更新项目知识图谱
/init

关键特点#

1. 生成 CLAUDE.md 文件：该文件包含项目所有文件的解析结果，是 AI 理解项目的核心依据
2. 支持手动编辑：你可以直接修改 CLAUDE.md 文件，添加框架说明、项目架构或其他重要信息
3. 自动作为上下文：后续与 Claude Code 的对话会自动引用 CLAUDE.md 文件，无需手动指定
4. 提升对话效率：有了完整的项目上下文，AI 能更准确地理解你的问题和需求

注意事项#

• /init 命令不会修改或创建除 CLAUDE.md 外的任何文件
• 大型项目可能需要较长时间来完成扫描和解析
• 建议定期更新 CLAUDE.md 文件，尤其是在项目结构发生重大变化后
• CLAUDE.md 文件可以添加到 .gitignore 中，避免不必要的版本控制

与其他命令的配合使用#

bash
复制
# 初始化项目知识，然后开始新的对话
/init
/clear

# 执行流程：
# 1. 生成 CLAUDE.md 文件，包含完整项目上下文
# 2. 清空历史对话，开始全新的对话
# 3. 新对话会自动使用 CLAUDE.md 作为上下文

最佳实践#

1. 新项目必用：在任何新项目中首次使用 Claude Code 时，先运行 /init
2. 定期更新：当项目文件发生较大变化时，重新运行 /init
3. 手动补充：根据需要手动编辑 CLAUDE.md，添加 AI 可能需要的额外信息
4. 合理管理：根据项目大小和需求，决定是否将 CLAUDE.md 添加到版本控制中